AcquireSourceFrame

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODWindow

AcquireSourceFrame
The AcquireSourceFrame method returns a reference to the frame, if any, from which this window was opened.
ODFrame AcquireSourceFrame ();
return value
A reference to the frame from which this window was opened, or kODNULL if the window does not have a source frame (for example, a root window).

DISCUSSION
This method increments the reference count of the returned frame. When you have finished using that frame, you should call its Release method.
If your part class implements shared dialog windows (which are shared by all part objects of your class in a document), your part objects can use the source frame of the dialog window to find out which frame is currently associated with the dialog window.
It is possible to change the source frame later by calling this window's SetSourceFrame method.

SEE ALSO
The ODWindow::SetSourceFrame method (page 836).